revXMLRootNode

Type

function

Summary

Returns the path to the starting node of an XML tree.

Syntax

revXMLRootNode(<treeID>)

Description

Use the revXMLRootNode function to get the path to an XML tree|XML tree's root node.

The root node is the starting node of the XML tree. The corresponding XML element is the one that contains all other elements in the XML document.

If the revXMLRootNode function encounters an error, it returns an error message starting with "xmlerr".

Important

The revXMLRootNode function is part of the XML library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "XML" checkbox is checked.

Parameters

Name	Type	Description
treeID		The number returned by the revXMLCreateTree or revXMLCreateTreeFromFile function when you created the XML tree.

Examples

revXMLRootNode(3)

put revXMLRootNode(thisTree) into myStartNode

Related

control structure: function

function: revXMLCreateTree, revXMLCreateTreeFromFile, revXMLNextSibling, revXMLPreviousSibling, revXMLParent, revXMLFirstChild

glossary: Standalone Application Settings, root node, standalone application, XML tree, return, LiveCode custom library

library: XML library

message: revXMLStartTree

command: revXMLDeleteNode

Compatibility and Support

Introduced

LiveCode 2.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile